home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Developer Toolbox 6.1
/
SGI Developer Toolbox 6.1 - Disc 4.iso
/
public
/
shar
/
README
< prev
next >
Wrap
Text File
|
1994-08-01
|
4KB
|
107 lines
toolbox/public/shar README
This directory contains shar -- a utility for building a shell
archive. A shell archive is a single file which contains a
collection of other files and/or directories which can be extracted
by /bin/sh. It is frequently used to send collections of files
through e-mail. This software is public domain, and may be
distributed and/or modified freely.
To compile and install shar, copy this directory to a local disk,
and type:
su
make install
This will install shar into your /usr/local/bin directory,
and the man pages for shar and traverse.
The "shar.shar" file is an archive of the original shar distribution.
Typical usage is:
shar -v file1 file2 ... file > shar.files
To extract the files:
chmod 555 shar.files
shar.files
The following is a copy of the shar man page.
-----------------------------------------------------------------
NAME
shar - create file storage archive for extraction by /bin/sh
SYNOPSIS
shar [-abcsv] [-d delim] [-p prefix] files
DESCRIPTION
shar prints its input files with special command lines
around them to be used by the shell, /bin/sh , to extract
them later. The output can be filtered through the shell to
recreate copies of the original files.
shar allows directories to be named, and shar prints the
necessary commands (mkdir & cd) to create new directories
and fill them. shar will emit commands to make executable
plain files executable. shar will not allow existing files
such files must be removed by the file extractor.
OPTIONS
-a All the options. The options: -v -c -b -p <tab>X are
implied.
-s Silent running. All checking and extra output is
inhibited.
-v Print verbose feedback messages about what shar is
doing to be printed during extraction. Sizes of plain
files are echoed to allow a simple validity check.
-c Check file size on extraction by counting characters.
An error message is reported to the person doing the
extraction if the sizes don't match. One reason why
the sizes may not match is that shar will append a
newline to complete incomplete last lines; shar prints
a message that mentions added newlines. Another reason
why the sizes may not match is that some network mail
programs remove non-whitespace control characters.
shar prints a message that mentions control characters
to the extractor.
-b Extract files into basenames so that files with
absolute path names are put into the current directory.
This option has strange effects when directories are
archived.
-d Use this as the ``end of file'' delimiter instead of
the default. The only reason to change it is if you
suspect an file contains the default delimiter:
SHAR_EOF.
-p Use this as the prefix to each line of the archived
files. This is to make sure that special characters at
the start of lines are not eaten up by programs like
mailers. If this option is used, the files will be
extracted with the stream editor sed rather than cat so
it is more efficient and portable to avoid setting the
prefix, though perhaps less safe if you don't know what
is in the files.
SEE ALSO
tar(1), cpio(1), tp(1), sh(1)
AUTHOR
Gary Perlman (based on a shell version by James Gosling,
with additions motivated by Derek Zahn, Michael Thompson, H.
Morrow Long, Fred Avolio, Gran Uddeborg, & Chuck Wegrzyn)
LIMITATIONS
shar does not know anything about links between files or
binary files.